Enrollment Settings

End Points

Attribute

is_authentication_handling_available

boolean

Specify whether Zoho Authentication is available. Applicable only for Cloud. Set to False for on-premises

selected_ad

string

The AD name when AD is integrated in Cloud

directory_authentication

string

When AD/Zoho Account auth mode is chosen, Need to give if AD auth or Zoho account auth. Values to be given for ZOHO Account: "Zoho Authentication"; Azure AD: "Azure Authentication" ; On Premise AD: "Microsoft On-Premises AD Authentication". This is required only in cloud

auth_mode

integer

Authentication method for enrolling devices using invites

OTP
AD/Zoho Account
Combination of both

email_unmanaged_alerts

string

email addresses to be notified when device gets unmanaged

notify_device_unmanaged

boolean

Specify whether a mail notification should be triggered when devices are unmanaged

is_ad_integrated

boolean

Specify whether AD is integrated

{
    "is_authentication_handling_available": true,
    "selected_ad": "Azure Authentication",
    "directory_authentication": "Azure Authentication",
    "auth_mode": 1,
    "email_unmanaged_alerts": "mdmzoho@zylker.com",
    "notify_device_unmanaged": true,
    "is_ad_integrated": true
}

Get Enrollment Settings

Get enrollment settings
oauthscope : MDMOnDemand.MDMAdmin.CREATE

GET - /api/v1/mdm/enrollmentsettings

curl --request GET \
  --url https://www.mdm.manageengine.com/api/v1/mdm/enrollmentsettings \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

HTTP/1.1

{
    "is_authentication_handling_available": true,
    "selected_ad": "Azure Authentication",
    "directory_authentication": "Azure Authentication",
    "auth_mode": 1,
    "email_unmanaged_alerts": "mdmzoho@zylker.com",
    "notify_device_unmanaged": true,
    "is_ad_integrated": true
}

Save Enrollment settings

Save enrollment settings for on-premises
oauthscope : MDMOnDemand.MDMAdmin.CREATE

POST - /api/v1/mdm/enrollmentsettings

Arguments

auth_mode

integer

(Required)

Authentication method for enrolling devices using invites

OTP
AD/Zoho Account
Combination of both

email_unmanaged_alerts

string

(Required)

email addresses to be notified when device gets unmanaged

notify_device_unmanaged

boolean

(Required)

Specify whether a mail notification should be triggered when devices are unmanaged

curl --request POST \
  --url https://www.mdm.manageengine.com/api/v1/mdm/enrollmentsettings \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "auth_mode": 1,
    "email_unmanaged_alerts": "mdmzoho@zylker.com",
    "notify_device_unmanaged": true
}

HTTP/1.1

{
    "status": "acknowledged"
}

Save Inactive Device Policy Settings

Save inactive device policy settings
oauthscope : MDMOnDemand.MDMAdmin.CREATE

PUT - /api/v1/mdm/inactive_device_policy_settings

Arguments

action_type

integer

(Required)

Action type to perform

No Action (default)
Remove Device
Retire Device
Unassign MDM License for Device

action_threshold

long

(Required)

threshold period to perform action on inactive device (default - 0 milliseconds)

inactive_threshold

long

(Required)

threshold period to move the device to new state

curl --request PUT \
  --url https://www.mdm.manageengine.com/api/v1/mdm/inactive_device_policy_settings \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "action_type": 1,
    "action_threshold": 1814400000,
    "inactive_threshold": 1728000000
}

HTTP/1.1

{
    "status": "acknowledged"
}

Delete Inactive Device Policy Settings

Delete devices that have not contacted the MDM server for a specified duration
oauthscope : MDMOnDemand.MDMAdmin.DELETE

DELETE - /api/v1/mdm/inactive_device_policy_settings

curl --request DELETE \
  --url https://www.mdm.manageengine.com/api/v1/mdm/inactive_device_policy_settings \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

HTTP/1.1

{
    "status": "acknowledged"
}